home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: MegaDisc / MegaDisc 24 (1991-10)(MegaDisc Digital Publishing)(AU)(Disk 2 of 2).zip / MegaDisc 24 (1991-10)(MegaDisc Digital Publishing)(AU)(Disk 2 of 2).adf / ART_GALLERY / Spyral_doc / Spyral_doc
Text File  |  1991-09-26  |  6KB  |  159 lines
  1.  
  2.  
  3.  
  4.  
  5. S P Y R A L
  6.  
  7.     Iterative polygonal spiral generator.
  8.  
  9.         Written by Michael Stapleton of Graphic Bits.
  10.         Please distribute the Spyral drawer intact.
  11.  
  12.  
  13.         This SHAREWARE program is copyright © 1991 .
  14.         ( See the end of this file for details. )
  15.  
  16.         by Michael Stapleton, Graphic Bits
  17.  
  18.  
  19.     ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ##
  20.  
  21.  
  22.  What does it do ?
  23.  
  24.     Spyral lets you draw a multi-colored polygon (any connected 'loop' of
  25.   straight lines). It completes your loop then shrinks and rotates it,
  26.   creating an intricate perspective spiralling pattern.
  27.  
  28.     Spyral can be started from WorkBench or the CLI. Simply Double-Click
  29.   on the Spyral icon, or type Spyral at the CLI prompt.
  30.  
  31.    For a quick demo:
  32.     Start Spyral.
  33.     Click a few points in the main screen area with
  34.     the Left Mouse Button (LMB).
  35.     Click the Right Mouse Button (RMB) to change colors !
  36.     Click a few more points in the main screen area with LMB.
  37.     Select (LMB) the Twist gadget.
  38.     Watch that spyral go!
  39.  
  40.     Spyral simply shrinks the end of each line towards its start, by the
  41.   fraction shown in the slider along the bottom of the window. This
  42.   amount can be easily adjusted in the usual Intuition style - slide it.
  43.   All other functions are accessed through the Gadget buttons OR by
  44.   keyboard shortcuts - the plain initial letter (no shift, Alt etc).
  45.   Sorry if you find some of these keywords confusing, but it gets tricky
  46.   doing this sort of thing !
  47.  
  48.  Controls
  49.  
  50.     Spyral has two modes of operation Edit mode and Twist mode, the
  51.   current mode is shown in the screen title bar.
  52.  
  53.     In Edit mode you can add or subtract from your polygon, or clear it
  54.   and start anew.
  55.  
  56.     In Twist mode you can view the results of your handiwork as it spins
  57.   its way to its centre.
  58.  
  59.     Some gadgets behave differently in the two modes, but these
  60.   differences will, I hope, seem logical and natural.  Generally, in Edit
  61.   mode you permanently affect the actual polygon but in View mode you only
  62.   affect the immediate display. The ratio gadget accepts input at
  63.   anytime, even when spyralling.
  64.  
  65.  Command  Summary
  66.  
  67.  Edit       As logic may suggest, this button puts you in Edit mode.
  68.           This is the starting mode of Spyral.
  69.  
  70.  Delete     In Edit mode, deletes last point. Can delete multiple
  71.           points. Inactive in Twist mode.
  72.  
  73.  Return     In Edit mode, returns the last deleted point. Can return
  74.           multiple points. Inactive in Twist mode.
  75.  
  76.  Clear      In Edit mode, CLEARS the POLYGON !!! There is NO undo.
  77.           In Twist mode, merely clears the screen.
  78.  
  79.  View       In Edit mode, clears the screen, redraws polygon and
  80.           connects last point to first. Useful after multiple Deletes
  81.           or Returns.
  82.           In Twist mode, clears the screen and retwists polygon.
  83.           Useful after changing the ratio.
  84.  
  85.  Twist      In Edit mode, selects Twist mode, connects last point to
  86.           first point in the current color, and twists (see Pause).
  87.           In Twist mode, retwists polygon.
  88.  
  89.  Pause      This button toggles between Pause and Play (keyboard p). It
  90.  Play       has no affect during Edit mode (but may be selected).
  91.           In Twist mode, pauses the polygon at the end of the current
  92.           loop. Select Play to continue twisting.
  93.  
  94.  File Commands -   Requester courtesy of C. Heath of Microsmiths.
  95.  
  96.    Save       Save polygon in ASCII format. Works anytime.
  97.  
  98.    Load       Load polygon in ASCII format, clearing current polygon.
  99.         Works anytime.
  100.  
  101.    Append     Append polygon in ASCII format to end of current polygon.
  102.         Works anytime. Quickly make giant, pulsating THINGS !
  103.         Just don't overflow the vector buffer ( 300 points ).
  104.  
  105.    IFF    Save whole screen in standard IFF ILBM format. No icon.
  106.         Works anytime.  Thanks to C. Scheppner of CBM,
  107.         J. Morrison, Steve Shaw etc. of Electronic Arts.
  108.  
  109.  
  110.    X      Locks mouse X co-ordinate so only vertical movement is
  111.         possible. Current mouse X co-ordinate value is displayed
  112.         on this button in Edit mode. Use keyboard to start lock.
  113.  
  114.    Y      Locks mouse Y co-ordinate so only horizontal movement is
  115.         possible. Current mouse Y co-ordinate value is displayed
  116.         on this button in Edit mode.  Use keyboard to start lock.
  117.  
  118.  
  119.     * Technical Note *
  120.  
  121.     You can 'return' funny points by Loading or Appending in Twist mode.
  122.   This is because the buffer is never cleared, only the pointers get
  123.   changed, and in twist mode I don't bother to reset the 'last deleted'
  124.   pointer. Experiment with this, and let me know how you feel about this
  125.   sort of 'unplanned feature' or any others you may discover!
  126.  
  127.  
  128.    Have fun and be creative.    M.
  129.  
  130.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  131.  
  132.     If you use this program please send one of the following :
  133.       a.    $15 Australian (Cheque prefered)
  134.       b.     5 blank disks
  135.       c.     3 art data disks (original or PD )
  136.       d.     Spare hard drives, color inkjet printers  etc. !
  137.  
  138.     To:
  139.         Graphic Bits
  140.         P.O. Box 674
  141.         Bankstown 2200
  142.         NSW, Australia.
  143.  
  144.     Your contribution will directly influence my continued
  145.     enthusiasm in this project.
  146.  
  147.     Future enhancements include:
  148.         Color cycling range(s).
  149.         Alternative color selection.
  150.         Faster, smaller, neater code.
  151.         Save as Animation ???
  152.         User-definable button(s).
  153.     Any suggestions, comments etc. are welcome.
  154.  
  155.  
  156.     ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ## 24 ##
  157.  
  158.  
  159.